home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / BBS / PKPRO13B.ARJ / ZCOLOR.DOC < prev    next >
Text File  |  1990-08-24  |  6KB  |  168 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                      ZCOLOR
  12.  
  13.  
  14.  
  15.  
  16.                        File Directory Maintenance Utility
  17.  
  18.  
  19.                             For Passkey Professional
  20.                          and all BBS programs supporting
  21.                       the standard file description format
  22.                     as defined by most popular BBS programs
  23.  
  24.  
  25.                             (c) 1990 - Zeblon Castel
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.           Registration
  35.           ------------
  36.  
  37.              All of the ZUTIL programs are free.  The only thing I ask
  38.           is that if you like and use any of the ZUTIL programs,
  39.           please pass the word on.  If you have the space on your
  40.           system, please carry a copy of the current release.
  41.  
  42.           Introduction
  43.           ------------
  44.  
  45.              ZCOLOR is a part of the ZUTIL set of file area
  46.           maintenance programs.
  47.                          ZCHECK - Batch program used to update file
  48.                                   directory listings to insure proper
  49.                                   date and file size.
  50.                          ZCOLOR - Batch program used to add color to
  51.                                   your file area listings.
  52.                          ZFILE -  Interactive program to allow the
  53.                                   moving and maintaining of file
  54.                                   listings and directories.
  55.                          ZSORT -  Batch program used to sort file
  56.                                   directory listings.
  57.  
  58.              ZCOLOR is a program designed to assist in the maintenance
  59.           of your Upload/Download directories on your system.  I wrote
  60.           it to maintain file directory listings for Passkey
  61.           Professional (by far the finest BBS software available) but
  62.           I designed it to be generic enough to support any set of
  63.           file listings that support the standard file area format.
  64.  
  65.              This utility does not read any cryptic system control
  66.           files allowing it to work with virtually any BBS you are
  67.           running.  From what I understand, some people are using
  68.           ZUTIL programs maintain file directory lists for their sets
  69.           of programs even without running a BBS.
  70.  
  71.  
  72.           File Listing Format
  73.           -------------------
  74.  
  75.              ZCOLOR will allow you to maintain your file area listings
  76.           if your file entries are in the following format:
  77.  
  78.           Col      Desc
  79.           -------------
  80.           1-12     Filename
  81.           15-21    File Size
  82.           24-31    File Date
  83.           32-80    File description.  (Can continue for multiple
  84.           lines)
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.               1-12       15-21    24-31         33 - 80
  92.           | -------- |  | --- |  | ---- | | ------------------------->
  93.           FILENAME.TYP  9999999  MM-DD-YY  File description that can
  94.                                          | continue for an unlimited
  95.                                          | number of lines
  96.  
  97.           Input
  98.           -----
  99.  
  100.              ZCOLOR requires as input a text file that will describe
  101.           the colors to use in the listings, and the fully qualified
  102.           file listings to maintain.  The default name for this file
  103.           is ZCOLOR.DAT but an alternate name can be specified as an
  104.           option when you execute ZCOLOR.  (ex: ZCOLOR myfile.dat.)
  105.  
  106.              The first five lines of the file define the colors to
  107.           apply to the listing:
  108.  
  109.           Line     Color used on:
  110.           ------------------------------------------------------------
  111.           --
  112.            1       File listing text before any file entries.
  113.            2       File Name
  114.            3       File Size
  115.            4       File Date
  116.            5       File Description Text
  117.  
  118.  
  119.              Valid colors are:
  120.  
  121.              Normal Intensity:
  122.                                RED
  123.                                GREEN
  124.                                YELLOW
  125.                                BLUE
  126.                                MAGENTA
  127.                                CYAN
  128.                                WHITE
  129.                                GREY
  130.  
  131.              High Intensity:
  132.                                REDH
  133.                                GREENH
  134.                                YELLOWH
  135.                                BLUEH
  136.                                MAGENTAH
  137.                                CYANH
  138.                                WHITEH
  139.                                GREYH
  140.  
  141.              You can also use NONE or IGNORE if you want no color
  142.           change for a specific item.
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.              Lines 6-n are fully qualifies names of the directories to
  150.           colorize.  The colorized file will have the same name of the
  151.           non-colorized file but will have the extension (filetype) of
  152.           ".C".  For example:  If your file list file is named
  153.           C:\BBS\PUBLIC\FILES. then your colorized file will be named
  154.           C:\BBS\PUBLIC\FILES.C.  If this is not in agreement with the
  155.           standards for the software you are running, you can rename
  156.           this file after it is colorized.
  157.  
  158.  
  159.           Support
  160.           -------
  161.              If you should have any problems with ZCOLOR or any of the
  162.           ZUTIL set of utilities, please contact me immediately.  I
  163.           can be contacted on any HyperMail system on either the
  164.           National Sysop Echo or the Passkey Support echo.  If you
  165.           can't find any HyperMail systems in your area, you can
  166.           contact me on the Passkey Professional support BBS in
  167.           Phoenix ((602) 894-6526).
  168.